home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / pmval.z / pmval
Encoding:
Text File  |  2002-10-03  |  11.1 KB  |  233 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMVVVVAAAALLLL((((1111))))                                                              PPPPMMMMVVVVAAAALLLL((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmvvvvaaaallll - performance metrics value dumper
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmvvvvaaaallll [----ddddggggrrrrzzzz] [----AAAA _a_l_i_g_n] [----aaaa _a_r_c_h_i_v_e] [----hhhh _h_o_s_t] [----iiii _i_n_s_t_a_n_c_e_s] [----nnnn
  13.      _p_m_n_s_f_i_l_e] [----OOOO _o_f_f_s_e_t] [----pppp _p_o_r_t] [----SSSS _s_t_a_r_t_t_i_m_e] [----ssss _s_a_m_p_l_e_s] [----TTTT _e_n_d_t_i_m_e]
  14.      [----tttt _i_n_t_e_r_v_a_l] [----wwww _w_i_d_t_h] [----ZZZZ _t_i_m_e_z_o_n_e] _m_e_t_r_i_c_n_a_m_e
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      ppppmmmmvvvvaaaallll prints current or archived values for the nominated performance
  18.      metric.  The metric of interest is named in the _m_e_t_r_i_c_n_a_m_e argument,
  19.      subject to instance qualification with the ----iiii flag as described below.
  20.  
  21.      Unless directed to another host by the ----hhhh option, or to an archive by the
  22.      ----aaaa option, ppppmmmmvvvvaaaallll will contact the Performance Metrics Collector Daemon
  23.      (PMCD) on the local host to obtain the required information.
  24.  
  25.      When processing an archive, ppppmmmmvvvvaaaallll may relinquish its own timing control,
  26.      and operate as a ``slave'' of a ppppmmmmttttiiiimmmmeeee(1) process that uses a GUI dialog
  27.      to provide timing control.  In this case, either the ----gggg option should be
  28.      used to start ppppmmmmvvvvaaaallll as the sole slave of a new ppppmmmmttttiiiimmmmeeee(1) instances, or ----pppp
  29.      should be used to attach ppppmmmmvvvvaaaallll to an existing ppppmmmmttttiiiimmmmeeee(1) instance via the
  30.      IPC channel identified by the _p_o_r_t argument.
  31.  
  32.      The ----SSSS, ----TTTT, ----OOOO and ----AAAA options may be used to define a time window to
  33.      restrict the samples retrieved, set an initial origin within the time
  34.      window, or specify a ``natural'' alignment of the sample times; refer to
  35.      PPPPCCCCPPPPIIIInnnnttttrrrroooo(1) for a complete description of these options.
  36.  
  37.      Options which control the source, timing and layout of the information
  38.      reported by ppppmmmmvvvvaaaallll are as follows:
  39.  
  40.      ----aaaa   Performance metric values are retrieved from the Performance Co-
  41.           Pilot (PCP) archive log file identified by the base name _a_r_c_h_i_v_e.
  42.  
  43.      ----dddd   When replaying from an archive, this option requests that the
  44.           prevailing real-time delay be applied between samples (see ----tttt) to
  45.           effect a pause, rather than the default behaviour of replaying at
  46.           full speed.
  47.  
  48.      ----gggg   Start ppppmmmmvvvvaaaallll as the slave of a new ppppmmmmttttiiiimmmmeeee(1) process for replay of
  49.           archived performance data using the ppppmmmmttttiiiimmmmeeee(1) graphical user
  50.           interface.  NNNNooootttteeee:  This option is supported on Irix only.
  51.  
  52.      ----hhhh   Current performance metric values are retrieved from the nominated
  53.           _h_o_s_t machine.
  54.  
  55.      ----iiii   _i_n_s_t_a_n_c_e_s is a list of one or more instance names for the nominated
  56.           performance metric - just these instances will be retrieved and
  57.           reported (the default is to report all instances).  The list must be
  58.           a single argument, with elements of the list separated by commas
  59.           and/or white space.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMVVVVAAAALLLL((((1111))))                                                              PPPPMMMMVVVVAAAALLLL((((1111))))
  71.  
  72.  
  73.  
  74.      ----nnnn   Normally ppppmmmmvvvvaaaallll operates on the default Performance Metrics Name
  75.           Space (PMNS), however if the ----nnnn option is specified an alternative
  76.           namespace is loaded from the file _p_m_n_s_f_i_l_e.
  77.  
  78.      ----pppp   Attach ppppmmmmvvvvaaaallll to an existing ppppmmmmttttiiiimmmmeeee(1) time control process instance
  79.           via the IPC channel identified by the _p_o_r_t argument.  This option is
  80.           normally only used by other tools, e.g.  ppppmmmmvvvviiiieeeewwww(1), when they launch
  81.           ppppmmmmvvvvaaaallll with synchronized time control.  NNNNooootttteeee:  This option is
  82.           suppored on Irix only.
  83.  
  84.      ----rrrr   Print raw values for cumulative counter metrics.  Normally
  85.           cumulative counter metrics are converted to rates.  For example,
  86.           disk transfers are reported as number of disk transfers per second
  87.           during the preceding sample interval, rather than the raw value of
  88.           number of disk transfers since the machine was booted.  If you
  89.           specify this option, the raw metric values are printed.
  90.  
  91.      ----ssss   The argument _s_a_m_p_l_e_s defines the number of samples to be retrieved
  92.           and reported.  If _s_a_m_p_l_e_s is 0 or ----ssss is not specified, ppppmmmmvvvvaaaallll will
  93.           sample and report continuously (in real time mode) or until the end
  94.           of the PCP archive (in archive mode).
  95.  
  96.      ----tttt   The default update _i_n_t_e_r_v_a_l may be set to something other than the
  97.           default 1 second.  The _i_n_t_e_r_v_a_l argument follows the syntax
  98.           described in PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), and in the simplest form may be an
  99.           unsigned integer (the implied units in this case are seconds).
  100.  
  101.      ----wwww   Set the width of each column of output to be _w_i_d_t_h columns.  If not
  102.           specified columns are wide enough to accommodate the largest value
  103.           of the type being printed.
  104.  
  105.      ----ZZZZ   By default, ppppmmmmvvvvaaaallll reports the time of day according to the local
  106.           timezone on the system where ppppmmmmvvvvaaaallll is run.  The ----ZZZZ option changes
  107.           the timezone to _t_i_m_e_z_o_n_e in the format of the environment variable
  108.           TTTTZZZZ as described in eeeennnnvvvviiiirrrroooonnnn(5).
  109.  
  110.      ----zzzz   Change the reporting timezone to the local timezone at the host that
  111.           is the source of the performance metrics, as identified via either
  112.           the ----hhhh or ----aaaa options.
  113.  
  114.      The following symbols may occasionally appear, in place of a metric
  115.      value, in ppppmmmmvvvvaaaallll output:  A question mark symbol (?) indicates that a
  116.      value is no longer available for that metric instance.  An exclamation
  117.      mark (!)  indicates that a 64-bit counter wrapped during the sample.
  118.  
  119.      The output from ppppmmmmvvvvaaaallll is directed to standard output.
  120.  
  121. FFFFIIIILLLLEEEESSSS
  122.      $$$$PPPPCCCCPPPP____VVVVAAAARRRR____DDDDIIIIRRRR////ppppmmmmnnnnssss////*
  123.                default PMNS specification files
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPMMMMVVVVAAAALLLL((((1111))))                                                              PPPPMMMMVVVVAAAALLLL((((1111))))
  137.  
  138.  
  139.  
  140. PPPPCCCCPPPP EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  141.      Environment variables with the prefix PPPPCCCCPPPP____ are used to parameterize the
  142.      file and directory names used by PCP.  On each installation, the file
  143.      /_e_t_c/_p_c_p._c_o_n_f contains the local values for these variables.  The
  144.      $$$$PPPPCCCCPPPP____CCCCOOOONNNNFFFF variable may be used to specify an alternative configuration
  145.      file, as described in ppppccccpppp....ccccoooonnnnffff(4).
  146.  
  147. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  148.      PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), ppppmmmmccccdddd(1), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmdddduuuummmmpppplllloooogggg(1), ppppmmmmiiiinnnnffffoooo(1), ppppmmmmllllooooggggggggeeeerrrr(1),
  149.      ppppmmmmttttiiiimmmmeeee(1), ppppccccpppp....ccccoooonnnnffff(4) and ppppccccpppp....eeeennnnvvvv(4).
  150.  
  151. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  152.      All are generated on standard error and are intended to be self-
  153.      explanatory.
  154.  
  155. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  156.      ppppmmmmvvvvaaaallll attempts to display non-integer numeric values in a way that does
  157.      not distort the inherent precision (rarely more than 4 significant
  158.      digits), and tries to maintain a tabular format in the output.  These
  159.      goals are sometimes in conflict.
  160.  
  161.      The following table describes the formats used for different ranges of
  162.      numeric values for any metric that is of type PPPPMMMM____TTTTYYYYPPPPEEEE____FFFFLLLLOOOOAAAATTTT or
  163.      PPPPMMMM____TTTTYYYYPPPPEEEE____DDDDOOOOUUUUBBBBLLLLEEEE, or any metric that has the semantics of a counter (for
  164.      which ppppmmmmvvvvaaaallll reports the rate converted value):
  165.                         __________________________________
  166.                           Format         Value Range
  167.                         __________________________________
  168.                                  !   No values available
  169.                          9.999E-99   < 0.1
  170.                             0.0      0
  171.                             9.9999   > 0 and <= 0.9999
  172.                             9.999    > 0.9999 and < 9.999
  173.                            99.99     > 9.999 and < 99.99
  174.                           999.9      > 99.99 and < 999.9
  175.                          9999.       > 999.9 and < 9999
  176.                          9.999E+99   > 9999
  177.                         __________________________________
  178.                         ||||||||||||
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.                                    ||||||||||||
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.                                                           ||||||||||||
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.                                                                         PPPPaaaaggggeeee 3333
  230.  
  231.  
  232.  
  233.